home *** CD-ROM | disk | FTP | other *** search
/ System Booster / System Booster.iso / Archives / ForCLI / wsz13.lzh / wsz.doc < prev   
Text File  |  1993-12-12  |  12KB  |  394 lines
  1. Note: I made some small edits for english. - Jim 8's  (uploader)
  2.       aites@hpsmpa.lvld.hp.com   -or-   jim@hpsmpk.lvld.hp.com
  3.  
  4. --------------------------------------------------------------------------
  5.  
  6.                 WSZ 1.3
  7.  
  8.                1992-09-18
  9.  
  10.             By Jimmy Westerlund
  11.  
  12.             FOR USE WITH V36+ ONLY !!!!!
  13.  
  14.  
  15.                 DISCLAIMER
  16.  
  17.     This program is FREEWARE. It may be spread to everyone under the
  18.     condition that no charge is taken except for disc- and copying costs.
  19.     The program may not be used as a part of a commercial product without
  20.     the written permisson of the author. The contents in the distribution
  21.     archive may not be changed. The author cannot be held responsible for
  22.     any damage the program may cause.
  23.  
  24.     If you like this program, you are free to send me something.
  25.     (Money, pictures (on disk, IFF or GIF), pictures (on paper),
  26.      dogfood (for granny:-), programs (NO pirate copies), greetings
  27.      and so on). But PLEASE don't send me anything that counts in
  28.     megaton, I prefer SEK :-). Swedish users can pay to my postgiro account.
  29.  
  30.  
  31.             ARCHIVE CONTENTS in version 1.3
  32.  
  33.             Name         What        Size
  34.               --------------- ---------------  -------
  35.             WSZ        Main file.    9332
  36.             WSZ.C        Source file.   15309
  37.             WSZ.DOC     This file      11953
  38.  
  39.  
  40.                 WHY
  41.  
  42.     This program was generated because I wanted to test an idea I had.
  43.     And it worked. WSZ allows you to easily change the size of a window,
  44.     either by specifying your own values or using one of the built in
  45.     options. A number of other commands are also included.
  46.  
  47.     NOTE: WSZ can only be used on V36 (2.00) or above!!!
  48.  
  49.  
  50.                   SYNTAX
  51.  
  52.     WSZ [flag] [flag] [flag] [and so on...]
  53.  
  54.  
  55.       Flags:
  56.     X[+|-|/|*|S]n    : Puts window n pixels from screens left border.
  57.     Y[+|-|/|*|S]n    : Puts window n pixels below screens top border.
  58.     W[+|-|/|*|S]n    : Change width of window to n pixels.
  59.     H[+|-|/|*|S]n    : Change height of window to n pixels.
  60.     E[+|-]n     : Changes the X-position of a screen.
  61.     T[+|-]n     : Changes the Y-position of a screen.
  62.     C[W|S|R]n    : Temporary changes the "active" window or screen.
  63.     I[S|W]        : Info about the window.
  64.     M[+|-]n     : Removes/adds bitmaps to a window.
  65.     U[W/S]        : Updates a window or screen.
  66.     Kn        : Closes a window.
  67.     Fn        : Move the window to the front.
  68.     Bn        : Move the window to the back.
  69.     Zn        : Zooms a window.
  70.     V        : Views a list of all screens and windows.
  71.     Dn        : Delays n/50 seconds before continuing.
  72.     Rn        : Repeat flags n times. n=0 for endless repeats.
  73.     An        : Sleeps until user changes window. Checks every
  74.               n/50 seconds.
  75.     Lfile        : Loads a script, located in either current dir or
  76.               in s:.
  77.  
  78.     Note : If no flags are specified, the flags XS YS WS and HS will be
  79.        used.
  80.  
  81.     Note II: If no command is used in one of the first four arguments,
  82.          the commands X, Y, W and H will be used. For example
  83.          WSZ 0 0 640 256 equals WSZ X0 Y0 W640 H256.
  84.  
  85.  
  86.               SUMMARY OF COMMANDS
  87.  
  88. ---------------------------------------------------------------------------
  89.  
  90.     COMMAND:        X - coordinate
  91.     SYNTAX:        X[+|-|S]n
  92.     PURPOSE:    This command puts the window n pixels to the right of
  93.         the screens left border.
  94.         If you specify a +, -, * or / the change will be relative
  95.         to the current position.
  96.         If S is used, then the value for the screen will be used.
  97.     EXAMPLE:    X10    : Puts the window 10 pixels from the border.
  98.         X+5    : Puts the window 5 pixels right of current
  99.               position.
  100.         X-10    : Moves the window 10 pixels to the left.
  101.         XS    : Same as X0
  102.  
  103. ---------------------------------------------------------------------------
  104.  
  105.     COMMAND:        Y - coordinate
  106.     SYNTAX:        Y[+|-|S]n
  107.     PURPOSE:    Same as the X command, but puts the window n pixels
  108.         below the top of the screen.
  109.     EXAMPLE:    Y10    : Puts the window 10 pixels below the top.
  110.         Y+5    : Moves the window down 5 pixels.
  111.         Y-10    : Moves the window 10 pixels up.
  112.         YS    : Same as X0
  113.  
  114. ---------------------------------------------------------------------------
  115.  
  116.     COMMAND:        Width
  117.     SYNTAX:        W[+|-|S]n
  118.     PURPOSE:    Changes the width of the window.
  119.     EXAMPLE:    W10    : Makes the window 10 pixels wide.
  120.         W+5    : Increases the width with 5 pixels.
  121.         W-10    : Decreases the width with 10 pixels.
  122.         WS    : Makes the window as wide as the screen.
  123.  
  124. ---------------------------------------------------------------------------
  125.  
  126.     COMMAND:        Height
  127.     SYNTAX:        H[+|-|S]n
  128.     PURPOSE:    Changes the height of the window.
  129.     EXAMPLE:    W10    : Makes the window 10 pixels high.
  130.         W+5    : Increases the height with 5 pixels.
  131.         H-10    : Decreases the height with 10 pixels.
  132.         HS    : Makes the window as high as the screen.
  133.  
  134. ---------------------------------------------------------------------------
  135.  
  136.     COMMAND:        lEft
  137.     SYNTAX:        E[+|-]n
  138.     PURPOSE:    Moves the top left corner of the active screen to
  139.         the X-coordinate n. Changes can be done relative to
  140.         current position using the + or - flag. See the
  141.         X command above.
  142.  
  143. ---------------------------------------------------------------------------
  144.  
  145.     COMMAND:        Update
  146.     SYNTAX:        U[W|S]
  147.     PURPOSE:    Updates a screen or window size/position. See bug
  148.         header for more info.
  149.  
  150. ---------------------------------------------------------------------------
  151.  
  152.     COMMAND:        Top
  153.     SYNTAX:        T[+|-]n
  154.     PURPOSE:    Moves the top left corner of the active screen to the
  155.         Y-coordinate n. See the E and the Y command above for
  156.         further information.
  157.  
  158. ---------------------------------------------------------------------------
  159.  
  160.     COMMAND:        Change
  161.     SYNTAX:        C[S/W/R]n
  162.     PURPOSE:    Temporary change the active "screen" or "window" to the
  163.         address n. If R is used, then the values will be resetted
  164.         to the real "active" screen and window.
  165.         NOTE: The address are to be written in DEC, not in hex.
  166.  
  167.     EXAMPLE:    WSZ V gave for example:
  168.            * Screen 'Workbench Screen' at adress 2419432...
  169.            *    Window 'AmigaShell' at adress 2362888
  170.             Window 'Workbench' at adress 2355888
  171.         if the user wants a info about the 'Workbench',
  172.         the following line could be used.
  173.  
  174.         WSZ CW2355888 IW CR
  175.     WARNING:    Be sure to enter a correct address when using this command.
  176.         An incorrect address can result in a CRASH!!! This command
  177.         is NOT for novice users. Use at your own risk....
  178.  
  179. ---------------------------------------------------------------------------
  180.  
  181.     COMMAND:        bitMap
  182.     SYNTAX:        M[+|-]n
  183.     PURPOSE:    Adds/removes bitmaps to/from a window. Removing one bitmap
  184.         from a 640*256 pixel large window frees 20480 bytes, but
  185.         reduces the number of colors available by half.
  186.     EXAMPLE:    WSZ M-        Removes all but one bitmaps from a window.
  187.         WSZ M-2     Removes all but two bitmaps from a window.
  188.         WSZ M+        Adds one bitmap to a window.
  189.         WSZ M+3     Adds bitplans until window got three bitmaps.
  190.  
  191. ---------------------------------------------------------------------------
  192.  
  193.     COMMAND:        Kill
  194.     SYNTAX:        Kn
  195.     PURPOSE:    Tries to close a window. Has the same effect as clicking on
  196.         the Closegadget. Doesn't work for windows without the
  197.         closegadget. If n is specified, then n will be used as the
  198.         address to the window, else current window is closed.
  199.  
  200. ---------------------------------------------------------------------------
  201.  
  202.     COMMAND:        Front
  203.     SYNTAX:        Fn
  204.     PURPOSE:    Moves the window to the front. If n is used, then the window
  205.         at the address n will be moved. Otherwise the active window.
  206.  
  207. ---------------------------------------------------------------------------
  208.  
  209.     COMMAND:        Back
  210.     SYNTAX:        Bn
  211.     PURPOSE:    Moves the window to the back. If n is used, then the window
  212.         at the address n will be moved. Otherwise the active window.
  213.  
  214. ---------------------------------------------------------------------------
  215.  
  216.     COMMAND:        Zoom
  217.     SYNTAX:        Zn
  218.     PURPOSE:    Zooms the window, same as clicking the zoom gadget. If
  219.         n is used, then the window at the address n will be
  220.         zoomed. Otherwise the active window.
  221.  
  222. ---------------------------------------------------------------------------
  223.  
  224.     COMMAND:        Information
  225.     SYNTAX:        I[W/S]
  226.     PURPOSE:    Prints information about the active screen and the active
  227.         window. If a flag is specified, then WSZ will print info
  228.         only about the [S]creen or the [W]indow.
  229.  
  230. ---------------------------------------------------------------------------
  231.  
  232.     COMMAND:        View
  233.     SYNTAX:        V
  234.     PURPOSE:    Displays a list of all screens and their windows.
  235.         A * means this screen/window is the active one.
  236.  
  237. ---------------------------------------------------------------------------
  238.  
  239.     COMMAND:        Delay
  240.     SYNTAX:        Dn
  241.     PURPOSE:    Sleeps in n/50 seconds.
  242.  
  243. ---------------------------------------------------------------------------
  244.  
  245.     COMMAND:        Active
  246.     SYNTAX:        An
  247.     PURPOSE:    Checks every n/50 second to see if the user activated
  248.         another window. When another is activated, WSZ continues
  249.         with the next command.
  250.  
  251. ---------------------------------------------------------------------------
  252.  
  253.     COMMAND:        Repeat
  254.     SYNTAX:        Rn
  255.     PURPOSE:    Repeats the commands n times. If n equals 0, the repeat
  256.         will be done forever. Nested repeats are allowed.
  257.  
  258. ---------------------------------------------------------------------------
  259.  
  260.     COMMAND:        Load
  261.     SYNTAX:        Lfile
  262.     PURPOSE:    Loads the file 'file' and executes the commands in the
  263.         file. 'file' must be located in either current directory
  264.         or in S: directory.
  265.  
  266. ---------------------------------------------------------------------------
  267.  
  268.                EXAMPLES
  269.  
  270.     1>    To change the size of the window:
  271.  
  272.     WSZ x10 y20 w500 h150     or
  273.     WSZ 10 20 500 150
  274.  
  275.     This makes the window 500 * 150 pixels large, with the upper
  276.     left corner at the position (10,20).
  277.  
  278.     2>    To change the width of the window:
  279.  
  280.     WSZ w450
  281.  
  282.     This gives the new window a width of 450 pixels.
  283.  
  284.     3>    To move the window to the upper left corner:
  285.  
  286.     WSZ x0 y0     or
  287.     WSZ 0 0
  288.  
  289.     4>    To change to size of an other window:
  290.  
  291.     WSZ d100 x10 y20 w500 h150
  292.  
  293.     This gives you 2 (100 / 50) seconds to activate the window which
  294.     will have the size as the window in Example 1.
  295.  
  296.     5>    To put a window to the back:
  297.  
  298.     WSZ b
  299.  
  300.     6>    To put an other window to the front:
  301.  
  302.     WSZ a50 f
  303.  
  304.     This checks every second to see if you've changed window.
  305.  
  306.     7>    To display info about the window:
  307.  
  308.     WSZ i
  309.  
  310.     8>    To move a window back and forvard a number of times:
  311.  
  312.     WSZ b f r50
  313.  
  314.     This puts the window back and forward 50 times.
  315.  
  316.     9> To display info forever:
  317.  
  318.     WSZ i r0
  319.  
  320.    10> To load and execute a script:
  321.  
  322.     WSZ Lscript
  323.  
  324.     This loads the file script and executes the commands just
  325.     as normal. If the file "script" cannot be found, WSZ will
  326.     look for "S:script" also.
  327.  
  328.  
  329.                    WARNING
  330.  
  331.     It might happen that a window doesn't like that you changed it's size,
  332.     which could result in something unexpected.  Be careful when resizing
  333.     another window.
  334.  
  335.  
  336.                    BUGS
  337.  
  338.     Only the LAST active window will be resized. This because the resizing
  339.     will be performed AFTER all other comands have finished. Otherwise the
  340.     window would "flash" four times if you change all four parameters.
  341.     The same "bug" exists if you moves a screen.
  342.  
  343.  
  344.                  THE FUTURE
  345.  
  346.     Do you got any suggetstions?? I'm running out of ideas.
  347.  
  348.  
  349.                   AUTHOR
  350.  
  351.     This program was written by:
  352.  
  353.     Jimmy Westerlund
  354.     Ringvägen 15
  355.     890 42 Mellansel
  356.        SWEDEN
  357.  
  358.     POSTGIRO : 740205-7835
  359.  
  360.     INTERNET : p3ta28@park1.park.se
  361.  
  362.  
  363.                 BEFORE THE END
  364.  
  365.     I wish to thank Roger Mårtensson and Björn Melinder for some ideas,
  366.     which made this program much more fun.
  367.  
  368.                    HISTORY
  369.  
  370.     V1.3    1992-09-18
  371.  
  372.     Added the bitMap, Kill, Top, lEft and Update commands.
  373.     Added the option / and * to the X, Y, W and H commands.
  374.     Added the address option to the F, B and Z commands.
  375.     Fixed a bug in the View command.
  376.  
  377.     V1.2    1992-09-02
  378.  
  379.     Added the View and Change commands. Fixed the Repeat command.
  380.     Improved the Info command.
  381.  
  382.     Bugs: The View command will not work correctly if the frontmost
  383.           screen isn't the active one. Fixed in 1.3.
  384.  
  385.     V1.1    1992-08-29
  386.  
  387.     Added the Zoom and Load commands. Rewrote command handling code.
  388.  
  389.     V1.0    1992-06-26
  390.  
  391.     The first version compleated.
  392.  
  393.  
  394.